@ash-qw/dsh-theme-prts 1.0.5 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 变更记录
 
+## 1.1.0 - 2026-10-12
+
+- 新增 sharp 服务端图片处理依赖，声明 Node.js ≥20.9.0；当前支持的 DSH 0.2.0-rc.2 已有更高的 Node.js 依赖要求。
+
+- 主题设置按外观、交互、会话流线和粒子效果分页，保留各页滚动位置与未完成的徽记编辑，支持窄屏顶部导航和键盘切换。
+
+- 支持自定义徽记素材包导出与导入，携带原图和调整参数，可跨 DSH 实例分享；导入先预览，再选择应用位置，并支持继续编辑。
+
+- 正文徽记排序改为长按整张徽记选项拖动，支持边缘自动滚动、取消还原和键盘排序，移除上移、下移按钮。
+
+- 新增 DSH 原生徽记工具：可在会话中读取上传图片、生成与调整粒子预览，并应用到新会话或正文列表；原图与参数保存在服务端，设置界面可继续编辑并实时同步，配置版本检查防止并发覆盖。
+
+- 新增徽记管理：新会话单图与正文轮换列表独立设置，支持本地上传、轮廓提取、裁剪预览，以及列表新增、替换、删除、排序和独立恢复内置图案。
+
+## 1.0.6 - 2026-10-10
+
+- 强化主题设置的四类分区边界和标题层级，将外观设置归为完整分区，并让导航高亮跟随正文滚动与定位。
+- 保留会话过程折叠栏的宿主原生样式，修复“已完成”等状态栏被通用按钮装饰覆盖成深色边框长条的问题。
+- 为发送后的用户消息临时回显补齐主题样式，避免正式消息到达时气泡、间距和头像发生突变；覆盖原生与通讯链条模式及窄屏布局。
+
 ## 1.0.5 - 2026-10-10
 
 - 重排主题设置为外观、交互、会话流线和粒子效果分区，新增分区定位导航，统一控件对齐、留白与明暗主题表现。

package/README.en.md

@@ -47,6 +47,14 @@ Cursor artwork comes from [crowninggg/prts-cursor v1.1.4](https://github.com/cro
 
 “Settings → Plugins → P.R.T.S.” provides the theme and startup-animation switches. The Rhodes Island emblem at the upper left of the main interface provides presets, environment texture, particle marks, interface material, navigation, and accessibility controls.
 
+The appearance panel has four pages: Appearance, Interaction, Session Flow, and Particle Effects. Switching pages preserves each page’s scroll position and unfinished emblem edits. On narrow screens, tabs appear above the content; arrow keys also switch pages.
+
+Under Particle Effects → Emblem Management, configure the new-session emblem independently from the conversation rotation list. Mix built-in and uploaded images in the list, preview or replace individual entries, add or remove entries (1–12). Long-press anywhere on an emblem card to drag it into a new position; release to save or press Escape to cancel. Keyboard users can press Space on the thumbnail, use arrow keys to reorder, and press Enter to save. Each area can be restored independently. Upload a PNG, WebP, or JPEG and adjust extraction, threshold, scale, and crop position before applying. Conversation emblems retain scroll-driven rotation, interaction, and reassembly. Images are uploaded to the current DSH host and processed in a separate worker thread. Sources, parameters, drafts, and applied settings are stored under `$DSH_HOME/plugins/dsh-theme-prts/emblems`, shared across workspaces, sessions, and browsers connected to that instance. Saved emblems remain editable and pages synchronize automatically. The theme does not send images to third-party image services. Images are limited to 8 MB and 16 megapixels; transparent logos or monochrome silhouettes work best.
+
+Click Export Asset on a custom emblem to download a single `.prts-emblem.json` package containing its source image and editing parameters. In another DSH instance, choose Add Emblem or Preview / Replace, then import the package and review it before applying. Imported emblems remain editable; importing does not automatically overwrite the hero or rotation list. Packages are limited to 12 MB; particles are rebuilt from the original parameters on import.
+
+In any DSH session where the tools are allowed, upload an image and ask the AI to preview it as a PRTS particle emblem. `prts_emblem_inspect`, `prts_emblem_preview`, and `prts_emblem_apply` let the AI adjust extraction, threshold, scale, and crop, then apply a draft to the new-session emblem or conversation rotation list. Previews do not change applied settings; conflicting writes require a fresh read. Previews appear in native chat tool cards; image-capable models also receive the preview as image input. Redrawing still requires an image-editing tool in that session. Around 200 recent drafts are retained, while editing sources for applied emblems are protected. Server-side processing requires Node.js 20.9 or later.
+
 The theme does not proactively restyle menus, dialogs, or overlays created by third-party plugins.
 
 ## Recovery and removal
@@ -61,7 +69,7 @@ Restarting DSH Web after removal is recommended. Browser theme preferences are r
 
 ## Development
 
-Node.js 18 or newer is required:
+Node.js 20.9 or newer is required (Node.js 24 is recommended, matching DSH):
 
 ```bash
 npm ci

package/README.md

@@ -45,7 +45,13 @@ npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 
 ## 使用与设置
 
-“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供预设、环境底纹、粒子徽记、界面材质、导航栏和辅助功能设置。
+“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供完整外观设置，按外观、交互、会话流线、粒子效果四页切换。各页保留滚动位置，切换不会丢失尚未应用的徽记编辑；窄屏使用顶部分类栏，也支持方向键切换。
+
+在“粒子效果 → 徽记管理”中，可分别设置新会话的单张徽记与正文的轮换列表。正文列表支持内置与自定义图案混排，每张可预览、上传替换或删除，长按徽记选项任意位置即可拖动排序，松开自动保存，Esc 取消，也可新增徽记（最多 12 张，至少保留 1 张）；两处均可独立恢复内置设置。上传 PNG、WebP 或 JPEG 后可调整轮廓提取、阈值、缩放及裁剪位置，点击“应用到此处”后才会保存。正文沿用滚动触发的轮换、扰动与重组效果。图片上传到当前 DSH 实例，在独立后台线程处理；原图、参数、草稿和已应用配置保存在 `$DSH_HOME/plugins/dsh-theme-prts/emblems`，不同工作区、会话及连接此实例的浏览器共享徽记设置。已应用图案可以重新打开继续调整，页面会自动同步。不会由主题插件发送给第三方图片服务。支持最大 8 MB、1600 万像素的图片，推荐透明底标志或黑白剪影。
+
+自定义徽记可点击“导出素材”，下载单张 `.prts-emblem.json` 素材包，包含原图和调整参数。在另一套 DSH 的“新增徽记”或“预览 / 替换”中选择“导入徽记素材包”，预览确认后应用；导入后仍可继续编辑，不会自动覆盖首页徽记或正文列表。素材包上限 12 MB，导入时会按原参数重新生成粒子。
+
+也可以在任意允许这些工具的 DSH 会话上传图片，说“帮我把这张图做成 PRTS 粒子徽记，先给我预览”。AI 可调用 `prts_emblem_inspect`、`prts_emblem_preview` 和 `prts_emblem_apply`，继续调整提取方式、阈值、缩放和裁剪，并按要求应用到新会话或正文轮换列表。生成预览不会改变已应用徽记，配置冲突会要求重新读取。预览图可在会话工具卡片中展示；使用支持图像输入的模型时，工具也会把预览图片交给模型分析。重画图案仍需要该会话另有图片编辑工具。保留最近约 200 份草稿，已应用徽记的编辑源不会被自动清理。服务端图片处理需要 Node.js 20.9 或更高版本。
 
 主题不会主动改写第三方插件的菜单、弹窗和浮层样式。
 
@@ -63,7 +69,7 @@ npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
 
 ## 开发
 
-需要 Node.js 18 或更高版本：
+需要 Node.js 20.9 或更高版本（推荐与 DSH 一致使用 Node.js 24）：
 
 ```bash
 npm ci